home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / music / prctmidi.lha / anleitung.txt next >
Text File  |  1996-01-30  |  13KB  |  295 lines

  1.  
  2.  
  3.                                  Project: MIDI  
  4.                                  -------------
  5.  
  6.                                   Version 1.01
  7.  
  8.                          (C) 1995, 96 by Matthias Specht 
  9.  
  10.  
  11. 1. WHAT'S IT??
  12.    -----------
  13.  
  14.    Project MIDI is a Tool to use your Amiga as a MIDI-Instrument!
  15.    Load some samples from disk, assign them to the MIDI-keys, choose a
  16.    MIDI-Channel for the Amiga - and your Amiga will play the samples like
  17.    you tell her!!      
  18.  
  19.  
  20. 2. WHAT DO I NEED?
  21.    ---------------
  22.  
  23.     - The program (ProjectMIDI) 
  24.       [assign the directory where the program is as 'ZMIDI:'!! 
  25.        Example: The PRG is in the directory sdh0:soundtools
  26.                 -> Execute "assign ZMIDI: sdh0:soundtools" !!
  27.        The best way: Put it in your Startup-Sequence]
  28.    - Amiga OS 2.0 or higher!!!!
  29.    - A MIDI-Interface & cables
  30.    - A MIDI-Sequencer / Keyboard (Project: MIDI doesn't make any sense 
  31.       without it!)
  32.    - Some cool samples, a digitizer in the best case!
  33.  
  34.  
  35. 3. HOW TO START/INSTALL IT
  36.    -----------------------
  37.  
  38.     [Sorry, I didn't use the easy Commodore-Installer, but it isn't hard at
  39.     all, and I think that every Amiga-user should know what the Shell is - 
  40.     or (s)he isn't worth to use my little child...(s)he/it won't be able to
  41.     zip this txt on the screen, anyway]
  42.  
  43.    A simple start: - Boot your (>= OS 2.0) Workbench
  44.             +++++  - Open a Shell (or CLI)
  45.                    - Type in (without the ",<,>):
  46.                      "assign ZMIDI: <the directory where ProjectMIDI is>"
  47.                      Example: "assign ZMIDI: ram:"
  48.                    - Start the PRG with a DoubleClick on the Icon or from
  49.                      the Shell
  50.  
  51.     A cool install: - Make a new directory for the PRG, if you want 
  52.           *******  - Copy the following files to the new drawer or where
  53.                      the hell you wanna have it:
  54.                      - ProjectMIDI
  55.                      - ProjectMIDI.info
  56.                    - insert the following line in your startup-sequence:
  57.                       assign ZMIDI: <your drawer, where you've put the PRG>
  58.                    - help yourself to a beer, work done!!!
  59.  
  60.  
  61. 4. SHORT: THE MENU-POINTS & GADGETS
  62.    --------------------------------
  63.  
  64.    Menu-Points:
  65.  
  66.    OPEN      : Opens a previously saved project
  67.    SAVE (AS) : Saves the project you're working at
  68.    ABOUT     : Try this, and your Amiga will speak a prayer
  69.    QUIT      : YES! It will quit the project and you'll exit ->BE CAREFULL!
  70.    
  71.    START     : Will start the connection to your MIDI-Sequencer. The Amiga
  72.                is an instrument now!
  73.    STOP      : Stops the previously startet operation. You can change your
  74.                Project now. The Amiga isn't an instrument anymore! She has
  75.                her own mind now!!
  76.  
  77.    LOAD A SAMPLE   : Opens a requester where you can choose a sample to load.
  78.    REMOVE A SAMPLE : Removes the marked sample (if it isn't used by a key)
  79.  
  80.    SET SERIALPORT : Hope you won't need this. 
  81.  
  82.                     The normal BAUDRATE is 31250, and you shouldn't have any 
  83.                     problems with it.
  84.                     I included this only because my old A2000(-A!!!!!) needs
  85.                     about 4 hours to be warm enough to work fine....
  86.          ---------> HEY! If you're a hardcore-hacker, check this out: 
  87.                     The longer the A2000 runs, the higher is the rate she
  88.                     accepts as '31250'. Directly after a power-up, it is 30050.
  89.                     Four hours later, it is 31250...what COULD it be? I suggest
  90.                     that the old PAULA is retired, but I ain't sure. If you have
  91.                     ANY Idea, please tell me!!
  92.  
  93.                     The SIZE OF THE BUFFER means the number of bytes which can
  94.                     be buffered. Perhaps you have to increase it on slow Amigas
  95.                     and excessive use of the serialport.
  96.  
  97.    SET MEM ACCESS : A window comes up, where you can switch between use of chip-
  98.                     memory only or chip- & fast-memory. Only samples in chip-mem
  99.                     can be played by the Amiga-Sound-Hardware, that means that 
  100.                     samples in the fast-mem have to be copied th chip-mem when
  101.                     they are played. That means high CPU-usage, 68'000-Amigas 
  102.                     might have troubles with the necessary speed, but it works
  103.                     fine on my old A500 (with the default buffer-size).
  104.  
  105.                    -Size of Buffers in CHIP-MEM: I use 8 buffers in the chipmem
  106.                      (2 for every channel, double-buffering). That means that
  107.                      you will loose 8 * this size!
  108.                      If this size is to small, the Amiga has to copy an extremely 
  109.                      high number of small datapackets. Every packet causes an 
  110.                      overhead (CPU-time will be lost). 
  111.                      But if you choose a size which is to large, you loose memory
  112.                      and the system has to copy some very big packets and this
  113.                      could cause timing-problems.
  114.  
  115.                     You see, choose the size wisely...you must TRY to find the 
  116.                     right one, it can't be calculated.
  117.    
  118.                    -# of Bytes copied before start: Before the sample can be 
  119.                      played, it has to be in chip-mem. Here, you can choose the
  120.                      number of bytes which have to be copied before the Amiga
  121.                      starts playing. To large = delay in the sound, To small = 
  122.                      the Amiga plays bytes which aren't in the sample...
  123.  
  124.    SWITCH AUDIO FILTER: Switches the Audio Filter on / off. Watch at your 
  125.                         Power LED...       
  126.                         
  127.    Gadgets:
  128.  
  129.    MIDI-Channel : Choose the MIDI-Channel under which your Amiga-Instrument
  130.                   should work
  131.  
  132.    Sound-Channel: Choose the Amiga-Sound-Channel on which the smaple should 
  133.                   be played
  134.    Play Sample  : Play the sample which is marked in the "Sample List"
  135.    Take Sample  : Takes the marked sample, the chosen Sound-Channel and 
  136.                   burns it into the marked key (on the keyboard in the under
  137.                   part)
  138.  
  139.    Edit Key     : Opens a window where you can edit the marked key, that 
  140.                   means you can change the Sample-Period and the Sound-
  141.                   Channel or even clear the key!!
  142.                   Click on 'DONE' or the Close-Gadget to leave, both is
  143.                   the same.
  144.  
  145.  
  146. 5. AN INTRODUCTION TO Project: MIDI
  147.    -------------------------------
  148.  
  149.    First, connect your Amiga to your MIDI-System in putting the MIDI-Inter-
  150.    face into the Serial-Port. DO THIS WITH YOUR MACHINE TURNED OFF!!!!!
  151.    Second, start the program. (Start/Install see above, point 3)
  152.    Then, load the samples you wanna use in your song. YEAH! Now, you can
  153.    see them in the 'Sample List'!!! Click on one of them. It's marked now.
  154.    Click on 'Play Sample' - and listen to your stereo...
  155.    Now to something completely different: The Keyboard below. One key is
  156.    allways marked, and you can read the informations about it in the upper
  157.    left corner.
  158.    Another component of your new world is the "Informations:" field, where
  159.    you can read some errors, messages and other shit. If you have problems -
  160.    look at it!!
  161.    Ouh, yes, you have loaded your samples (if the PRG wasn't able to load
  162.    them see point 6 - problems). Now, click on one of the keys on the key-
  163.    board - it is marked now. Click on 'Take Sample'. Watch now at the key-
  164.    information-field - and you will read something. That means that the 
  165.    sample is now assigned to the key - abstract: if you press the key of 
  166.    your new Amiga-instrument, she'll play the sample!!
  167.    Hope you understood the principle - you aren't new to the MIDI-Stuff, 
  168.    are you?
  169.    O.K. - The next gadget ist the MIDI-Channel-field. Hope you know what a
  170.    MIDI-Channel is. Choose the channel on which your Amiga will be active.
  171.    If you wanna change the parameters of a key, click on 'Edit Key'. There
  172.    you can change the sampling-rate and the sound-channel...OOOOH!
  173.    THE SOUND-CHANNEL:
  174.    As you know, the Amiga has four sound-channels. For every key you 
  175.    can/must choose a channel on which the sample will be played.
  176.    ATTENTION: If a key is 'pressed' which startes a sample on a channel on
  177.    which another sample is already running at this time, the running sam-
  178.    ple will be abortet and the new will be started immediately!
  179.    You see: Choose the channel carefully!
  180.    If you have chosen all your samples & keys, I suggest you to save the
  181.    configuration. Pick easily 'SAVE AS' out of the menu and all the NAMES
  182.    of the samples and the configuration of the keyboard will be saved.
  183.    Note that the sample-datas aren't saved, so the file is much shorter
  184.    but Project: MIDI needs the directories/disks where the samples are again
  185.    when you load the project!! 
  186.    Now, let the party begin. Choose START out of the OPERATION-Menu.
  187.    Your Amiga is an instrument now. (STOP! Your Amiga is a multitasking ma-
  188.    chine, and I've programmed this PRG with respect to it, but we won't go
  189.    to far in this small text, will we?)
  190.    The only thing you can do in Project: MIDI now is to pick STOP out of
  191.    the OPERATION-Menu. But you can play on her with your MIDI-Sequencer!! 
  192.    And watch the keyboard: It's played by a ghost...
  193.  
  194.    Hope you understood. Or do you have the courage to call me up under the
  195.    address below?    
  196.  
  197. 5.5 NEWS in this version
  198.     ----
  199.  
  200.     - Bug in 'remove a sample' detected & killed.
  201.  
  202.     - Error in sample-reader which caused 'blips' (noise at the start of a
  203.       sample) removed.
  204.  
  205.     - In Version <= 1.00 were some errors in recieving the MIDI-commands.
  206.       Is O.K. now.
  207.  
  208.     - Audio-Filter switch. 
  209.  
  210.     - The bigest bug was that samples >128 kb haven't been played right - 
  211.       but now it's ok! 
  212.  
  213.     - You can use FAST-MEMORY!!!
  214.       If you have only chip-memory : Turn the use of fast-mem of, you'll have
  215.       more memory to use!
  216.       (If fast-mem is installed: aumatically switched on, of no fast-mem: 
  217.        automatically switched off)
  218.  
  219.     - Memory-control: A new little field shows the free mem and the largest
  220.       free blocks.
  221.     
  222.     - Some bugs removed.
  223.  
  224.     - Errors will come up in a requester and other small beautyfull tricks!!
  225.  
  226. 6. PROBLEMS (which will never occur!!! (??))
  227.    --------
  228.  
  229.    - You wanted to load a sample - Error in the IFF-Structure reported:
  230.       Save your samples as IFF-FILES! And DON'T COMPRESS them!!
  231.       Sorry, but I was to lazy to include a superb IFF-Reader and to check
  232.       out how the IFFParse.Library works - so, I have to say that there
  233.       might be problems. If you can't load uncompressed IFF-Samples, try 
  234.       this: Load them into another Sound-PRG (not the same in which you
  235.       have saved them the last time) and sav'em again. Perhaps Project: 
  236.       MIDI can read this versions...(Try it with AUDIOMASTER!!!)
  237.  
  238.    - You can't see the entire screen (the keyboard is cutted):
  239.       You're working on an NTSC-Amiga. Put it in Pal-Mode. If you can't 
  240.       but REALLY wanna have this PRG, contact me. If it is needed, I'll
  241.       make a NTSC-Version.
  242.  
  243.    - Other problems / Bug-report: See address below.
  244.  
  245.  
  246. 7. COPYRIGHT
  247.    --------- 
  248.  
  249.    This program is in the public domain. 
  250.    It may be copied as often as possible, but *only* WITH THIS TEXTFILE 
  251.    inluded, WITHOUT ANY CHANGES at the files and for NO MONEY!!!!
  252.    (Money for copying and for a disk is o.k., but only $2 or so!!!)
  253.  
  254.    PD-Series/CD-Compilations: 
  255.    I would like to see my child on sth. like that! See restrictions above
  256.    and PLEASE inform me where & when you put it!
  257.  
  258.  
  259. 8. HOW TO CATCH ME
  260.    ---------------
  261.    
  262.    I'm: Matthias Specht (Who told that I'm Zarros of Z-The Revenge???)
  263.         Höhenstrasse 43
  264.         CH-9230 Flawil
  265.         Switzerland
  266.  
  267.    Or am I this guy? : mspecht@iiic.ethz.ch
  268.  
  269.    I would like you to contact me!
  270.    I would like you even more to send me money, a cool CD, your old damaged
  271.    or your new fast Amiga, a thrilling book, a good wine or something else!
  272.  
  273.  
  274. 9. I SAW ELVIS!
  275.    ------------
  276.  
  277.    Stop eating meat. Stop hating. Stop killing.
  278.    START THINKING!
  279.  
  280.    Don't believe everything some authorities say. THINK!
  281.  
  282.     
  283. 10. WHERE?
  284.     ------
  285.  
  286.     Do you know the Misfits? - If yes, listen to Mommy...
  287.     Do you know Head Like A Hole? - If no, go watch'em!
  288.     Have you coded a DEMO/INTRO? - Please send me!!! (I'll take even some
  289.      boring system-oriented PRGs like P.:M. Main thing: you have done it
  290.      yourself)
  291.     Get Z-REVENGE from Aminet/demos/euro!
  292.     Are you down? Listen the song 'Another Perfect Day' of the holy Lemmy &
  293.     co.!
  294.  
  295.